Using the Camera node

Use the Camera node to show the content of a Scene in your Kanzi Studio project and in your Kanzi application. When you create a Scene it contains only a Camera node and a Directional Light. This is the default Camera node and preview camera for that Scene. When a Camera node is a preview camera, in the Preview you see the Scene through that Camera node. In the Project the preview camera is marked with (Preview).

Do not scale Camera nodes, or ancestors of Camera nodes, using either Render Transformation or Layout Transformation properties. When you scale a Camera node you affect the projection so that it does not match the parameters you set.

Setting the position of Camera nodes

To set the position of a Camera node:

1. In the Preview select the Camera tool.
   
2. In the Camera tool you can use either orbit or free camera:
   
   • Orbit camera allows you to move around the nodes selected in the Project or the node set in the Look At property of the camera. To move with the orbit camera, use these controls:

     Control	Description
     Click and drag the left mouse button.	Rotate
     Click and drag the middle mouse button. Press the Space key, and click and drag the left mouse button.	Pan
     Scroll the mouse wheel. Press the Shift and Alt keys, and click and drag the left mouse button.	Zoom

     
     
   • Free camera allows you to move around without attachment to any point. To move with the free camera, use these controls:
     

     Control	Description
     W	Move forward. Hold down Shift to double the speed.
     S	Move backward. Hold down Shift to double the speed.
     A	Move left. Hold down Shift to double the speed.
     D	Move right. Hold down Shift to double the speed.
     Q	Tilt left.
     E	Tilt right.
     Click and drag the left mouse button.	Rotate
     Click and drag the middle mouse button.	Pan
     Scroll the mouse wheel.	Set camera speed. Scroll down to decrease the camera speed. Scroll up to increase the camera speed.

3. When setting the position of a Camera node use these controls:
   

   Control	Description
   	Store the current position of the camera to the preview Camera node.
   	Reset the camera to the current position of the preview Camera node.
   	Create a new Camera node from the current position of the camera.
   	Bring the camera to the 3D object selected in the Project or the Preview.
   	Select the Camera node through which you want to view the current scene.
   	Set the field of view for the camera in degrees when working with 3D nodes.

Turning a Camera node into a preview camera

When a Camera node is a preview camera, in the Preview you see the Scene through that Camera node. In the Project the preview camera is marked with (Preview).

To turn a Camera node into a preview camera:

• In the Project double-click the Camera node you want to turn into a preview camera.

Or

1. In the Project select the scene where you what to turn a Camera node into a preview camera.
2. In the Properties in property Camera > Preview Camera select the Camera node you want to use as the preview camera.
   

If the scene is not visible in the Preview even after you set a preview camera, you need to activate the scene. See Using the Scene node.

Viewing the active Scene from the preset viewpoints

The Camera tool allows you to quickly view the content of an entire Scene from one of the preset viewpoints: front, back, top, bottom, left, or right side. Unless you switched on the option to store the current position of the camera (), the preset viewpoints do not change the position of the Camera nodes in a Scene. See Setting the position of Camera nodes.

To view the entire active Scene from a preset viewpoint:

1. In the Preview select the Camera tool.
   
2. Use these shortcuts:

   Preset viewpoint	Shortcut
   View an entire Scene from the left side.	Shift+1
   View an entire Scene from the right side.	Shift+2
   View an entire Scene from the top.	Shift+3
   View an entire Scene from the bottom.	Shift+4
   View an entire Scene from the front.	Shift+5
   View an entire Scene from the back.	Shift+6

Creating a new Camera node

You can create a new Camera node in these ways:

1. In the Preview select the Camera tool.
   
2. Use either the orbit or free camera to move to the location where you want to create a new camera and click . See Setting the position of Camera nodes.
   Kanzi Studio creates a new Camera node in the position of the camera.

Or

• In the Project press Alt and right-click the Scene or any 3D node where you want to create a Camera node and select Camera.
  

Setting the projection type of a Camera node

To set the projection type of a Camera node, in the Project select the Camera node and in the Properties set the Projection Type property:

• Perspective to set the camera to show objects closer to Camera node larger than those that are further away. This is the projection type most commonly used for 3D scenes.
• Orthographic to set the camera to so that the distance from the Camera node does not affect the drawing size of objects. You can use an orthographic camera to show a 2D view of a 3D scene.

Using the Camera node in the API

Create a camera with a perspective projection:

// Create a camera named Camera.
CameraSharedPtr camera = Camera::create(domain, "Camera");
// Set the projection of the camera to perspective.
camera->setPerspectiveProjection();

// Make the viewing box display a horizontal 90 degree cone of the 3D space.
// The vertical cone angle is determined by the viewport aspect ratio.
camera->setFovType(Camera::YFov);
camera->setFov(90.0f);
camera->setZNear(0.1f);
camera->setZFar(100.0f);

Create a camera with an orthographic projection:

// Create a camera named Camera.
CameraSharedPtr camera = Camera::create(domain, "Camera");
// Set the projection of the camera to relative orthogonal.
camera->setOrthogonalProjection(Camera::OrthogonalCoordinateSystemRelative);

// Make the viewing box display [-width,width] x [-1, 1] x [-1, 1] portion of the 3D space.
// The width of the viewing box is determined by the viewport aspect ratio.
camera->setOrthogonalPlaneHeight(1.0f);
camera->setZNear(-1.0f);
camera->setZFar(1.0f);

For details, see the Camera class in the API reference.

Camera property types and messages

For a list of the available property types and messages for the Camera node, see Camera.

See also

Making nodes turn to a Camera node

Camera nodes

Editing your application in the Preview

Open topic with navigation